home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 002 / rgbtech.arc / GUIDE3 < prev    next >
Text File  |  1986-11-25  |  11KB  |  250 lines
  1.  
  2.  
  3.  
  4.                                        13
  5.  
  6.  
  7.         3. FILE COMMANDS
  8.           
  9.              RGB-TechWriter is invoked by typing TW in response to the
  10.         DOS prompt.  Once the program has been loaded, RGB-TechWriter
  11.         will display an introductory title screen.  This screen includes
  12.         a message to remind you to prepare your file storage disk before
  13.         continuing.  If you have a fixed disk, and the default path is
  14.         set to drive C:, then no action is needed.  Otherwise, insert the
  15.         appropriate diskette in the designated drive.  To proceed, press
  16.         Enter (carriage return).  You will now be presented with the file
  17.         screen menu, and RGB-TechWriter will list a directory of the
  18.         files in the appropriate directory on the default drive.  RGB-
  19.         TechWriter files are listed without their extension, which is
  20.         always .TWF (for TechWriter File).  Whenever you refer to a file
  21.         and don't provide an extension, RGB-TechWriter assumes you are
  22.         referring to a TechWriter file.  To refer to a file that does not
  23.         have an extension, you must enter the period which normally
  24.         separates the file name from its extension, but nothing after it.
  25.         To exit RGB-TechWriter and return to DOS, use the X command.  If
  26.         you have altered the length of the file in memory without saving
  27.         it, a warning is issued and you must confirm your desire to exit,
  28.         because the text in memory will be lost.
  29.         
  30.         
  31.         3.1 Directories
  32.           
  33.              The files listed on the menu screen are those found in the
  34.         current directory on the current drive.  RGB-TechWriter files are
  35.         shown first, followed by as many other files as will fit on the
  36.         screen.  If there is still room, any subdirectories within the
  37.         current directory are listed.  The following file commands are
  38.         available for controlling the directory listing:
  39.         
  40.         L - List Directory. If you want to get a listing of the files on
  41.         a new diskette using the same drive, this command simply updates
  42.         the directory information on the screen to match the diskette
  43.         currently in place.  This is necessary because RGB-TechWriter has
  44.         no way of knowing that you have changed the diskette until you
  45.         issue this command.
  46.         
  47.         N - New Directory Path.  Use this command if you want to change
  48.         either the drive or the directory which RGB-TechWriter uses to
  49.         save and retrieve files.  To change to another drive, simply
  50.         enter the drive letter followed by a colon.  To change
  51.         directories, enter the path specifier for the new directory.
  52.         Details on path specifiers can be found in your DOS manual.  Or,
  53.         you can change to a specified directory on a new drive by
  54.         entering the new drive letter, a colon, and the path specifier.
  55.         If the specified path does not exist, a warning is issued and the
  56.         directory remains unchanged.  If you attempt to use a drive which
  57.         does not have a diskette in place, a time delay is provided to
  58.         allow you to insert the disk.  If no action is taken, the program
  59.         will issue a warning and proceed with the new drive as the
  60.         default.  If the directory change is successful, a listing of the
  61.  
  62.  
  63.         FILE COMMANDS
  64.  
  65.  
  66.                                        14
  67.  
  68.  
  69.         files in the new directory is displayed.
  70.         
  71.         
  72.         3.2 Retrieving Files
  73.           
  74.              Before you can edit or print a document, it must be resident
  75.         in the computer's memory.  Once a file is in memory, it is
  76.         referred to as the current "text", rather than a "file."  You can
  77.         retrieve any of the files listed in the directory shown on the
  78.         screen which are either RGB-TechWriter files or standard ASCII
  79.         files.  Executable program files are also listed (extensions .EXE
  80.         and .COM), but RGB-TechWriter is not designed for them.  ASCII
  81.         files are the type created by the DOS program EDLIN and several
  82.         other word processors.  ASCII files are what most compilers
  83.         expect for input.  RGB-TechWriter files look a lot like standard
  84.         ASCII files except that at the end of the file an extra section
  85.         is appended which contains the color information for the special
  86.         symbols in the text.  The following commands are provided for
  87.         retrieving files:
  88.         
  89.         G - Get a File.  This command allows you to specify the file to
  90.         be read into memory.  If there is already text in memory, and it
  91.         has been altered in length since the last time it was saved, RGB-
  92.         TechWriter will issue a warning and ask for confirmation.  This
  93.         is because reading a new file into memory will erase the previous
  94.         contents.  If the new file is an RGB-TechWriter file then the
  95.         margins, pitch, line length, and tabs are set as they were when
  96.         that file was last saved.  If the new file is an ASCII file, this
  97.         additional information is not stored with the file.  The line
  98.         length is set to 80 columns initially, but is expanded if any
  99.         lines are found to be longer than this.  The tabs for ASCII text
  100.         are set at intervals of 4 columns.  If the file is longer than
  101.         the maximum text length allowed, only the first part is read in
  102.         and the file in memory is assigned the name ERROR to prevent
  103.         inadvertent revision of the file.
  104.         
  105.         C - Clear Text.  The "Get a File" command assumes that the file
  106.         you want to work on already exists in some form.  But every file
  107.         has to start sometime.  If you want to start fresh and there is
  108.         something else in memory, this command will clear the text memory
  109.         and leave you with a blank slate.  Think of this as "getting" a
  110.         file which happens to be empty and has no name.  If the text in
  111.         memory has been altered in length since the last time it was
  112.         saved, RGB-TechWriter will issue a warning and ask for
  113.         confirmation before clearing it out.
  114.         
  115.         
  116.         3.3 Saving Files
  117.           
  118.              When you create or edit text using RGB-TechWriter, the
  119.         information resides only in the computer's memory until you
  120.         direct RGB-TechWriter to record the information on a fixed or
  121.         floppy disk.  It is a good idea to save your text in this way
  122.         every 15 to 30 minutes.  That way a power outage or accidental
  123.  
  124.  
  125.         FILE COMMANDS
  126.  
  127.  
  128.                                        15
  129.  
  130.  
  131.         erasure won't set you back more than that amount of time.  RGB-
  132.         TechWriter uses two different commands for saving files to disk.
  133.         This approach insures that you don't erase a file on the disk by
  134.         mistake, and also makes it easy to revise your disk file at
  135.         frequent intervals.  The two commands provided are:
  136.         
  137.         S - Save a File.  If you are saving the file for the first time,
  138.         you are immediately prompted to provide a name for the file.
  139.         This name can have up to 8 characters.  Letters, numbers, and
  140.         several other symbols are permitted.  If the file is to be an
  141.         ASCII file, then you must also specify an extension which is a
  142.         period followed by from zero to three characters.  If the name
  143.         given is acceptable, the text in memory is stored on the current
  144.         disk in the current directory.  The settings for margins, tabs,
  145.         and line width are stored with the file if it is an RGB-
  146.         TechWriter file.
  147.         
  148.              If the text in memory is from an existing file, you are
  149.         asked if you want to save the current text under the same file
  150.         name and create a backup copy.  If this is your intent, the
  151.         previous contents of the file are renamed to make the backup and
  152.         the current text is saved under the current file name.  The
  153.         renamed backup file will have the same name but a different
  154.         extension.  The extension is .TWB for TechWriter files, or .BAK
  155.         for ASCII files.  If you don't want to save the text under its
  156.         original name, respond to the backup question by hitting the "N"
  157.         key.   You will then be asked for a new file name.  If a file
  158.         already exists with the new name given, a warning is issued and
  159.         no action is taken.  This prevents you from overwriting another
  160.         file with the same name you may have forgotten about.  If there
  161.         is not enough room on the disk for your file, the disk is write-
  162.         protected, or there is no disk in the drive, a warning is issued
  163.         and the file is not saved.
  164.         
  165.         R - Revise a File.  Once you have saved a file for the first time
  166.         and given it a name using the Save a File command, following
  167.         further modifications you may just want to replace the old
  168.         version with the new version and not bother with a backup copy.
  169.         This command does just that.  It uses the same name you gave when
  170.         you got the file into memory, and saves the current memory
  171.         contents back under that same name.  If RGB-TechWriter can't find
  172.         the original file (perhaps you changed directories or diskettes),
  173.         a warning is issued and no action is taken.  If there is not
  174.         enough room on the disk for your file, the disk is write-
  175.         protected, or there is no disk in the drive, a warning is issued
  176.         and the file is not updated.  Pay particular note to the
  177.         insufficient disk space warning, because the old version of your
  178.         file will be erased when this occurs, leaving you with only the
  179.         text in memory.
  180.         
  181.         
  182.  
  183.  
  184.  
  185.  
  186.  
  187.         FILE COMMANDS
  188.  
  189.  
  190.                                        16
  191.  
  192.  
  193.         3.4 Deleting Files
  194.           
  195.              Eventually you will generate more files than you know what
  196.         to do with.  DOS provides a way of erasing unwanted files, but
  197.         RGB-TechWriter also provides this service as a convenience:
  198.         
  199.         D - Delete a File.  You are asked for the name of the file you
  200.         wish to delete.  If that file does exist in the current directory
  201.         on the current disk drive, then you are asked for a confirmation
  202.         before the file is erased from the disk.
  203.          
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.         FILE COMMANDS 
  250.